Homes.co.nz Scraper

Slug: fatihtahta/homes-co-nz-scraper

Overview

Homes.co.nz Scraper collects structured property records from https://homes.co.nz, including public listing or property URLs, addresses, prices, property attributes, coordinates, images, agency and agent details, open-home times, listing status, and source valuation signals. It supports location-based searches with optional deal, price, bedroom, bathroom, and sold-date filters for repeatable New Zealand real estate datasets.

Why Use This Actor

• Market research and analytics: monitor supply, pricing, location, bedrooms, bathrooms, area, valuation, and availability signals.
• Data engineering: feed normalized property records into ETL jobs, warehouses, BI tools, search indexes, or enrichment pipelines.
• Lead and inventory workflows: collect public addresses, agents, agencies, listing URLs, property facts, and media links.
• Recurring monitoring: schedule repeated runs to track visible public listings and property-market changes over time.

Input Parameters

Parameter	Type	Description	Default
location	string	Required search location, such as a suburb, town, city, region, or address.	-
deal_type	string	Listing status to collect: all_homes, for_sale, sold, for_rent, or not_listed.	all_homes
sold_within_months	string	Sold-result window used only when deal_type is sold.	12_month
min_price	integer	Minimum price in NZD. For rental searches, this represents weekly rent.	-
max_price	integer	Maximum price in NZD. For rental searches, this represents weekly rent.	-
min_bedroom	string	Minimum bedroom count: 1, 2, 3, 4, or 5+.	-
max_bedroom	string	Maximum bedroom count: 1, 2, 3, 4, or 5+.	-
min_bathroom	string	Minimum bathroom count: 1, 2, 3, 4, or 5+.	-
max_bathroom	string	Maximum bathroom count: 1, 2, 3, 4, or 5+.	-
limit	integer	Maximum number of records to save for the location.	-

Example Inputs

Broad Location Discovery

{
  "location": "Wellington",
  "deal_type": "all_homes",
  "limit": 50
}

Filtered Homes For Sale

{
  "location": "Auckland Central",
  "deal_type": "for_sale",
  "min_price": 600000,
  "max_price": 1200000,
  "min_bedroom": "2",
  "min_bathroom": "1",
  "limit": 100
}

Recently Sold Properties

{
  "location": "Christchurch",
  "deal_type": "sold",
  "sold_within_months": "3_month",
  "min_bedroom": "3",
  "max_bedroom": "5+",
  "limit": 75
}

Output

The actor writes normalized JSON records to the default Apify dataset. Normal rows use record_type: "property_listing" and group data into stable real estate objects:

• source_context: source URLs, seed context, page index, fingerprint, and source IDs.
• entity: title, description, public URL, status, category, and display identity.
• listing: listing ID, deal type, listing type, publication dates, and open-home times.
• pricing: displayed price, numeric price, currency, valuation, rental estimate, and yield signals.
• location: address, street, suburb, city, country, coordinates, and territorial authority.
• property: property ID, type, beds, baths, area, parking, building details, features, and legal details.
• availability: availability date, viewing times, tenants, pets, and smoker signals.
• media: main image, image URLs, image metadata, source media, videos, and image-use flags.
• contact_details and relationships: agents, agency, branch, and related business entities.
• attributes: source-specific fields, source flags, raw property/detail payloads, and remaining public source values.

Recommended idempotency key: record_id. Use source_context.listing_url or source_context.external_ids as secondary audit and join keys.

Example Record

{
  "record_type": "property_listing",
  "record_id": "95219381-a243-4ea5-bfc1-725cdb026f3d",
  "source_context": {
    "source_name": "Homes.co.nz",
    "source_domain": "homes.co.nz",
    "source_url": "https://homes.co.nz/address/auckland/mount-roskill/10-rogan-street/krZ2v",
    "listing_url": "https://homes.co.nz/address/auckland/mount-roskill/10-rogan-street/krZ2v",
    "canonical_url": "https://homes.co.nz/address/auckland/mount-roskill/10-rogan-street/krZ2v",
    "seed_id": "39d313c317c6",
    "seed_type": "location",
    "seed_value": "10 Rogan Street, Mount Roskill",
    "page_index": 1,
    "fingerprint": "37fd947618db78bd432f",
    "external_ids": {
      "source_id": "95219381-a243-4ea5-bfc1-725cdb026f3d",
      "property_id": "95219381-a243-4ea5-bfc1-725cdb026f3d",
      "item_id": "95219381-a243-4ea5-bfc1-725cdb026f3d"
    }
  },
  "entity": {
    "title": "10 Rogan Street, Mount Roskill, Auckland",
    "name": "10 Rogan Street, Mount Roskill, Auckland",
    "url": "https://homes.co.nz/address/auckland/mount-roskill/10-rogan-street/krZ2v",
    "external_ids": {
      "source_id": "95219381-a243-4ea5-bfc1-725cdb026f3d",
      "property_id": "95219381-a243-4ea5-bfc1-725cdb026f3d"
    }
  },
  "listing": {
    "property_status": 2,
    "is_featured": false,
    "published_at": "2008-11-11T00:00:00+00:00"
  },
  "pricing": {
    "price": 1550000,
    "price_text": "1550000",
    "currency": "NZD",
    "price_numeric": 1550000,
    "price_value": 1550000,
    "display_price_short": "1.55M",
    "valuation": {
      "capital_value": 1575000,
      "improvement_value": 325000,
      "land_value": 1250000,
      "estimated_value_text": "1.55M",
      "estimated_lower_value_text": "1.47M",
      "estimated_upper_value_text": "1.64M",
      "estimated_value_revision_date": "2026-05-28",
      "current_revision_date": "2024-05-01"
    },
    "rental_estimate": {
      "estimated_rental_lower_value_text": "830",
      "estimated_rental_upper_value_text": "1,000",
      "estimated_rental_revision_date": "2026-06-02",
      "estimated_rental_yield": "3.1%"
    },
    "estimated_value": "1.55M",
    "estimated_yield": "3.1%"
  },
  "location": {
    "address": "10 Rogan Street, Mount Roskill, Auckland",
    "full_address": "10 Rogan Street, Mount Roskill, Auckland",
    "street": "ROGAN STREET",
    "street_number": "10",
    "neighborhood": "MOUNT ROSKILL",
    "suburb": "MOUNT ROSKILL",
    "city": "AUCKLAND",
    "region": "AUCKLAND",
    "country": "New Zealand",
    "country_code": "NZ",
    "latitude": -36.919925689697266,
    "longitude": 174.745849609375,
    "coordinates": {
      "latitude": -36.919925689697266,
      "longitude": 174.745849609375
    },
    "map_url": "https://image-service./fit/640/460/generate?property_id=95219381-a243-4ea5-bfc1-725cdb026f3d&state=2",
    "territorial_authority": "7"
  },
  "property": {
    "property_id": "95219381-a243-4ea5-bfc1-725cdb026f3d",
    "bedrooms": 4,
    "bathrooms": 0,
    "floor_area": 255,
    "floor_area_sqm": 255,
    "land_area": 813,
    "lot_area": 813,
    "area_unit": "sqm",
    "parking_spaces": 2,
    "off_street_parking": 2,
    "garage_parking": 1,
    "decade_built": "1950",
    "features": {
      "has_deck": false,
      "has_laundry_or_workshop": false,
      "first_gas_enabled": false
    },
    "building_details": {
      "building_construction": "BI",
      "building_site_coverage": 255,
      "contour": "LV",
      "view_type": "O"
    },
    "legal": {
      "legal_description": "LOT 146 DP 17584",
      "ownership_type": "Freehold",
      "certificate_of_title": "NA464/206"
    }
  },
  "media": {
    "main_image_url": "https://homes-listing-images.s3.ap-southeast-2.amazonaws.com/properties/large/95219381-a243-4ea5-bfc1-725cdb026f3d",
    "thumbnail_url": "https://homes-listing-images.s3.ap-southeast-2.amazonaws.com/properties/large/95219381-a243-4ea5-bfc1-725cdb026f3d"
  },
  "metrics": {
    "sales_count": 2,
    "estimated_yield": "3.1%"
  },
  "attributes": {
    "flags": {
      "estimate_model_release_date": "2025-01-22",
      "estimate_model_version": "v3",
      "first_gas": "false",
      "sky": "false",
      "ultra_fast_fiber": "false"
    },
    "source_specific": {
      "state": 2,
      "ta": "7",
      "city_id": 100004,
      "suburb_id": 996,
      "property_detail_status_code": 200,
      "solar": {
        "estimate": "1,193",
        "potential": "Excellent"
      }
    }
  }
}

Data Quality, Guarantees, And Handling

• Fields may vary by deal type, location, listing status, and source availability.
• Source valuation, rental estimate, yield, ownership, and legal fields are saved as public source context, not as verified valuations, ownership proof, or legal records.
• IDs, postal/address components, phone-like values, title references, and source IDs are preserved as strings when appropriate.
• Empty source values are omitted from records.

Tips For Best Results

• Start with a small limit and inspect the first saved records.
• Use specific suburbs, towns, or addresses for tighter datasets.
• Use deal_type and sold-date filters to separate active listings, rentals, sold properties, and off-market property pages.

Export Formats And Downstream Use

Apify datasets can be exported as JSON, CSV, Excel, XML, or RSS. JSON is recommended for preserving nested normalized groups such as pricing, property, media, relationships, and attributes.

Limitations

• Coverage depends on what Homes.co.nz exposes publicly at run time.
• Some records are property/address pages rather than active sale or rental listings.
• Price and valuation fields may be text-only or source-estimate signals.

Compliance & Ethics

Use the actor responsibly and only for lawful workflows. Respect applicable terms, privacy obligations, and downstream data-use requirements.

Support

For help, open an issue on the actor page and include your input, run ID, and a short description of the expected result.